home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / qzc10.zip / QZC.DOC < prev    next >
Text File  |  1993-01-17  |  7KB  |  176 lines
  1.                             ┌─────────┐
  2.                             │ QZC.EXE │
  3.                             └─────────┘
  4.  
  5.                   Quick ZIP File Comment Utility
  6.                             Tom Kellen
  7.                            φ ßETATech φ
  8.  
  9. ═════════════════════════════════════════════════════════════════════
  10.  
  11. PURPOSE:  To quickly change, add or strip the file comment from ZIP
  12.           files and to optionally reset the date of the ZIP to either
  13.           today's date, the date of the latest member file within the
  14.           ZIP or to retain the original date.
  15.  
  16.  
  17.  
  18. INTRODUCTION:
  19.  
  20. Being a BBS sysop is often a thankless and frustrating job.  I was
  21. being frustrated by having to use several different utilities to
  22. change the ZIP comment on files uploaded to me and to reset the date
  23. of the ZIPs.  These many utilities accomplished the job but each was
  24. lacking something.  Finally I was frustrated enough to write QZC.EXE.
  25. QZC will rapidly add a comment to any ZIP file (SFX self extracting
  26. files too) and can also reset the date of the ZIP file.  Optionally
  27. it can also be used to strip unwanted ZIP comments.  Several of the
  28. advantages of using QZC are that it is very fast and will NOT disturb
  29. -AV stamps on ZIP files.
  30.  
  31.  
  32.  
  33. INSTALLATION:
  34.  
  35. QZC should be placed into a subdirectory that is somewhere on your
  36. path for maximum flexibility.  You can configure how QZC operates by
  37. placing QZC.CFG, an ASCII text configuration file in the same
  38. directory with QZC.EXE.  The configuration file is optional and QZC
  39. can either be run with defaults or over ridden by command line
  40. parameters.
  41.  
  42.  
  43.  
  44. OPERATION:
  45.  
  46. QZC runs with two defaults.  The first is where it looks for the text
  47. file containing the comment you wish to add to your ZIPs.  By default
  48. it looks for a file called LOGO in the root of your C: drive
  49. (ie. C:\LOGO).  The comment file should be created with an ASCII
  50. editor and can contain any number of lines as long as it is less than
  51. 32K (it is highly recommended that you keep your comments as small as
  52. possible).  The second default is to reset the date of the ZIP file
  53. to the same date and time as the member file with the latest date and
  54. time.  This gives the truest picture of the date of the content files.
  55.  
  56. The easiest way to configure QZC is to create (or edit the enclosed
  57. sample) QZC.CFG file.  There are two key words that can be used in the
  58. file.  The first is COMMENTFILE=.  This key word indicates the name
  59. and location of the file containing the comment you wish to add to
  60. each ZIP.  An example might be COMMENTFILE=C:\ZIPS\BBS.AD.  This would
  61. add the comment found in the file C:\ZIPS\BBS.AD to each ZIP.  In the
  62. configuration file, any text following a semicolon is considered a
  63. comment and ignored.  Lines can be commented out in QZC.CFG by
  64. starting the line with a semicolon.  If you wish QZC to remove ZIP
  65. comments and not to add a new one you could put COMMENTFILE=STRIP in
  66. your QZC.CFG file.  This will cause QZC to act as a comment stripper
  67. instead of a file commenter.
  68.  
  69. The second key word is ZIPDATE=.  There are three key words that can
  70. be used following the = sign.  ZIPDATE=ORIGINAL will comment the ZIP
  71. (or strip the comment) while retaining the original file date and
  72. time.  ZIPDATE=CURRENT will change the date and time of the ZIP to the
  73. current date and time.  ZIPDATE=LATEST will scan all the member files
  74. to determine the latest date and time of those files and then set the
  75. ZIP to that latest date.
  76.  
  77. By default, QZC will look for QZC.CFG in the same directory as QZC.EXE
  78. resides in.  If you wish to use different configurations, you can
  79. create different .CFG files and then use the command line parameter
  80. /CFG= to force QZC to use an alternate configuration file.  For
  81. example, QZC /CFG=C:\ZIPS\QZC2.CFG will use the configuration
  82. parameters found in C:\ZIPS\QZC2.CFG.  This should afford the user
  83. quite a bit of flexibility in operation as each configuration file can
  84. specify different comment files too.
  85.  
  86. Using /S on the command line will force QZC to strip the comments from
  87. the specified files.  Command line parameters always override the
  88. commands found in a .CFG file.
  89.  
  90. /C will force QZC to set the ZIP date to the current date and time.
  91. /O will retain the original date and time found on the ZIP file.  /L
  92. will set the date and time to match that of the latest file member
  93. contained within the ZIP.
  94.  
  95. If QZC encounters any problems in commenting or setting the date and
  96. time of a file, it will show this on the screen and will also create
  97. a file called QZC.LOG in the directory where QZC.EXE resides.  This
  98. log file will contain the date and file name of the file QZC had
  99. trouble with.
  100.  
  101. QZC can be used on one file or many.  If you don't specify a file name
  102. on the command line, QZC will assume that you wish to comment *.ZIP.
  103. For example, you could issue the command QZC T*.ZIP to comment all the
  104. files beginning with T and ending in .ZIP, or QZC *.exe to comment all
  105. your self extracting ZIP files.  If a file is not in ZIP format, QZC
  106. will report the error and continue on.
  107.  
  108.  
  109.  
  110. EPILOGUE:
  111.  
  112. Hopefully users and BBS SysOp's alike will find this utility useful.
  113. It is distributed under the Shareware concept, where you get to try
  114. it out before you buy.  The cost for QZC is $2.00 US.  This seems to
  115. be a minimal but reasonable fee for this program.  If you don't feel
  116. it is worth that amount, please let me know what features I could add
  117. to enhance it.  If you find that QZC is not what you need, just delete
  118. it and move on, you've lost nothing.  Registering QZC will give you
  119. the warm fuzzy feeling that you've done the right thing and that
  120. you've helped to continue the great concept of Shareware.  Please
  121. register any software that you use to encourage the authors to
  122. continue.  QZC is not crippled in ANY way and there is no "registered"
  123. version.  Registered QZC will be informed of new ßETATech utility
  124. programs and will possibly receive price breaks in registering them.
  125.  
  126.  
  127. AUTHOR CONTACT:
  128.  
  129. Problems, solutions, kudos and ideas are welcomed.  I can be reached
  130. at the following:
  131.  
  132. By mail:
  133.  
  134. ßETATech
  135. P. O. Box 566742
  136. Atlanta, GA  31156-6013
  137.  
  138.  
  139. Electronically:
  140.  
  141. The Right Place BBS
  142. 404/476-2607
  143. 9,600 Baud HST
  144.  
  145. Solid Rock BBS
  146. 909/785-9176
  147. 1200-38400 USR DS
  148.  
  149. I can also be contacted via the RIME network's SHAREWARE, SPITFIRE
  150. BBS, SCUBA and TURBO PASCAL conferences.
  151.  
  152.  
  153. DISCLAIMER:
  154.  
  155. Use of this program acknowledges this disclaimer of warranty: "This
  156. program is supplied as is.  ßETATech Computer Consulting disclaims all
  157. warranties, express or implied, including, without limitation, the
  158. warranties of merchantability and of fitness of this program for any
  159. purpose.  ßETATech Computer Consulting assumes no liability for
  160. damages direct or consequential, which may result from the use of this
  161. program."
  162.  
  163.  
  164.  
  165. ACKNOWLEDGEMENTS:
  166.  
  167. My grateful thanks to John Newlin, author of ArcMaster and ArcMaster
  168. For Windows for his assistance in working with compressed files.  John
  169. has been of invaluable assistance in all my programming endeavors and
  170. is a wonderful mentor.
  171.  
  172.  
  173.  
  174. REVISION HISTORY:
  175.  
  176. 17-JAN-1993    v1.0      Initial Release.